'\" t
.TH cm2_cmpreleases 1 "20 September 2006" "Code Manager II"

.SH NAME
cm2 compare releases \- Show difference between two tags

.SH SYNOPSIS
.TS
l l.
cm2 compare releases	[\fB--project\fP \fIP\fP] [\fB--releases\fP \fIr1[,r2]\fP]
	[\fB--style\fP \fIreport|patch\fP] [\fB--long\fP] [\fB--xml\fP]
	[\fB--verbose\fP]
.TE

.SH DESCRIPTION
The \fPcm2 compare releases(1)\fP utility is used to compare any two tags for a 
particular project. Of course no results are given if the project in question does
not yet have two tags.

By default the results given are for the project based in the current working 
directory, and the results compare the two most recent tags. The arguments
available allow the output of the command to be varied.

.SH ARGUMENTS
.TP 8
.B --project
The name of the project to show the differences for rather than attempting to 
ascertain it from the current working directory.
.TP
.B --releases
Specify one or two releases to overcome the default ones taken. If just one 
release is specified then it that release and the most recent are compared.
If two releases are given then the differences between them are showed.

The order of the releases specified does not matter - the results will always
compare the oldest against the newest.
.TP
.B --style
The default output format is 'report' - this given a summary of the 
differences by showing the files removed, added and changed between the
two releases. If a file has more than one version checked in between 
the details of each checked in version are shown.

The alternative value is 'patch'. In this instance output is suitable to
pass to the \fIpatch(1)\fP command. Although useful in some cases this 
format does not include information on file removal, just additions or
changes.
.TP
.B --long
Extend the standard 'report' style output by including the time/date of each
check in and the developer that performed it.
.TP
.B --xml
Show the results of the 'report' style of output, combined with \fB--long\fP
in an XML format.
.TP
.B --verbose
Show more information regarding the tag comparison process.

.SH EXIT CODES
The \fIcm2 compare releases(1)\fP follows UNIX standard practise:

.TP 4
.B 0
The comparison process completed successfully.
.TP
.B >0
An error occurred during the comparison; it is likely to be incomplete.

.SH AUTHOR
The \fBCode Manager II\fP tool set was written by Simon Edwards, Proprius Consulting Ltd, (\fBwww.proprius.co.uk\fP).

.SH SEE ALSO
.BR cm2_cmpprojects(1),
.BR cm2_listreleases(1),
.BR cm2_tagrelease(1),
.BR cm2_tagremove(1).

.SH AVAILABILITY
This utility was specifically written under the GNU GPL license and as required
by such software comes with \fIno warranty or guarantee of any kind\fP.

